home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / ra / daystat1.zip / DAYSTAT.DOC < prev    next >
Text File  |  1994-07-03  |  11KB  |  272 lines
  1.                                DayStat v1.0beta
  2.  
  3.                     Calls/Messages-Per-Day Bulletin Generator
  4.                              For RemoteAccess 2.0x
  5.  
  6.                              (c)1994   Jan Kulozik
  7.                --------------------------------------------------
  8.  
  9. What The Heck Is It?
  10. --------------------
  11.  
  12.         Actually, it's a collection of small utilities that I'd written,
  13. and just decided to lump together into one file.  Wasn't going to
  14. distribute it, but then I gave it to Vicki Fletcher (of My Desk BBS
  15. @1:138/0 in case you feel like meeting a brave sysop <g>) and she talked
  16. me into it.
  17.  
  18.         All it does is this...
  19.  
  20.         * Callers-Per-Day ANSI/ASCII bargraph bulletin
  21.         * Messages-Per-Day ANSI/ASCII bergraph bulletin
  22.         * Today's callers bulletin, complete with automasking
  23.           of local logins with a 14400 baud rate, and drawing
  24.           attention to new users.  Creates .ANS/.ASC so you
  25.           don't have to shell out and actually run a program.
  26.         * Yesterday's callers bulletin.  (See above.  Fingers tired)
  27.         * Export the last caller information to Frontdoor.
  28.                 * Inbound history
  29.                 * Log File
  30.                 * Last Inbound Call on status screen
  31.         * Sets Frodo's callers today information to reality.
  32.                 (Frodo counts EVERY drop to the BBS.  Resets this to
  33.                  number of ACTUAL calls)
  34.         * Ummm...  low fat...  high in protein.
  35.  
  36.         Remember, this is a BETA!  If you have ANY problems, let me know!
  37.  
  38.         Oh well...  it's free.  Do with it as you will.
  39.  
  40.  
  41. Disclaimer:
  42. ------------
  43. You know, I really hate these things.  I hate writing them.  Sheesh...
  44. Hokay, look mon...  if this here puppy does a thing...   I mean
  45. _ANYTHING_ including, but not limited to:  Running, causing your clock to
  46. blink 12:00, causing microwave interference to where all of your
  47. fillings glow red-hot, the reappearance of Jimmy Hoffa, little people to
  48. come out of your computer and shout "Would you cut it out?!?!  We're
  49. trying to sleep!!!", You to win the lottery...  but unable to find your
  50. ticket...  Too bad.  It ain't my fault.  :^P
  51.  
  52. (And BTW, I live in Tennessee...  I can say ain't if I want.  .snicker.)
  53.  
  54.         Anyway, here's the scoop...
  55.  
  56. The Scoop...
  57. ------------
  58.  
  59.         To install this puppy, just stick it in a directory anywhere.
  60. It's own, RA's, it doesn't matter.  It'll look for its data files in the
  61. directory that you called it from.  DAYSTAT.CFG, DAYSTAT.DAT, and DAYSTAT.TMP
  62. to be precise.
  63.  
  64.         Some command-line params...
  65.  
  66.         /N# - Node number.  This thing will support (From how I gather
  67.               it) a number of nodes limited by your freespace.  Very
  68.               important so you don't write over other nodes' data.
  69.               (Makes sense, eh?)  ;^)
  70.  
  71.         /T  - Write temporary data to DAYSTAT.TMP.  I'll explain in a
  72.               sec.
  73.  
  74.         /B  - Don't fiddle with data, just reads current data and write
  75.               out your bulletins.  (Also doesn't need the /N# parameter)
  76.  
  77.         /L  - Writes out information to a log-file...  looks amazingly
  78.               like this...
  79.  
  80. ...From DAYSTAT.LOG...
  81.  
  82.    Date┐    Time┐         Name┐            Posted┐ Temp┐ User┐ Post┐ Call┐
  83.        │        │             │                  │     │     │     │     │
  84. 6/6/94   06:35:35 --> Bill Crawford  0    11    11    13     8
  85. 6/6/94   06:46:23 --> Jan Kulozik  0  2819  2819    13     8
  86. 6/6/94   06:59:32 --> Michael Sanders  1     2     3    14     9
  87. ...
  88.         {Hokay, so I'm a message poster.}     }:^)
  89.  
  90.         /NOBULL - Don't write the MPD/CPD bulletins.  Used in conjunction
  91.                   with the /B command, it essentially skips the MPD/CPD
  92.                   stuff altogether.
  93.  
  94.         /F      - Process the FrontDoor Info.  (IE. write to the log or
  95.                   history files)
  96.  
  97.         /CT     - Generate a list of Today's Callers.
  98.                   (Will always be TODAY.ANS/ASC in your textfiles dir)
  99.  
  100.         /CY     - Generate a list of Yesterday's Callers.
  101.                   (Will always be YEST.ANS/ASC in your textfiles dir)
  102.                   (Run this in your midnight event, since your LASTCALL.BBS
  103.                    will be reset with your first caller after midnight)
  104.  
  105.         Here's how the whole thing works.  In RA 1.11, you could just
  106. check the HMB to see if any messages had been posted.  Well, with the
  107. advent of the .JAM message base format you can scratch that idea. .sigh.
  108. Believe me, I've pounded my head against a wall for a better way to do
  109. this, but I can't come up with one.  (If you can, LET ME KNOW!)
  110.  
  111.         I didn't want to look at the logfiles...  there are other
  112. programs to do that, and besides...  it's just too much of a major pain
  113. to track down EVERY message written in EVERY door.  So here's the plan.
  114.  
  115.         First go into RACONFIG in your OPTIONS>SYSTEM menu, and (if it's not
  116. already) set your "Text Shells" to Yes.  Sorry, but it's required.  What
  117. this does (for the unenlightened) is allows your system to run an
  118. external program if it's pointed to in a bulletin/textfile preceded by a
  119. Ctrl-X.
  120.  
  121.         However, you can put as your first option in your TOP.MNU a type
  122. 66 command with OFF for the optional data.  That'll turn off
  123. Textfile-Shells for the remainder of the call.  The important thing is
  124. that they're enabled for the WELCOME.ANS, which is the first thing shown
  125. after the system knows who the person is.
  126.  
  127.         Now then, pull up whatever program you use and change your
  128. WELCOME.ANS/ASC to where the first line calls up DAYSTAT.  Here's my
  129. line...
  130.  
  131.               ^Xe:\ra\daystat\daystat.exe /N*N /T|
  132.  
  133.         The "|" at the end, BTW, is required by RA.  If it's not there, RA will
  134. just treat the line like another line of text.  Again, the /N is
  135. required.  The *N, BTW, passes the node number.
  136.  
  137.         At this stage, the /T is essential.  This tells DayStat to read
  138. the user's EXITINFO.BBS and pull out the relevant info.  Then it writes
  139. it into the temp file.  When DayStat is run without the /T (When the
  140. user logs off) it retrieves this info from this particular node-slot,
  141. and processes the data.
  142.  
  143. (Warning: I've had a report of animated mode in TheDraw not allowing RA
  144. to recognize the ^X for what it is, and not shelling out.  If it doesn't
  145. drop-to-DOS, and you don't see something pop up with a DayStat display
  146. for a second it's not working.  Thanks, -Ed.)
  147.  
  148.         If you look at the log example above, you'll see that it
  149. compares the user's record after logoff to what it reads immediately
  150. after login to find out how many messages were written.  It's more
  151. complicated that I want, but I have to admit that it's relatively fast.
  152. :^)
  153.  
  154.         BTW, if you want you can just stick in an automatic menu option
  155. into your TOP.MNU to execute it.  But a warning...  if you do this,
  156. you'll miss any replies that someone might write in a NewMail scan.
  157. (Believe me, I know.  That's how I was originally running it.)  :^(
  158.  
  159.         That's about it.  All that's left is to put into your batch file a
  160. command to execute DayStat immediately after logoff so it can compare the
  161. User's updated record to what it recorded from the EXITINFO.BBS.
  162.  
  163. This, of course is...
  164.  
  165. DAYSTAT.EXE /N(node number)
  166.  
  167.         That's it.  Unless you want to do any of the other functions, in
  168. which case just tack on whatever switches you want.  Don't worry,
  169. they're interchangeable.  Just plug-n-play.  (I just wouldn't use the /T
  170. again.  <G>)
  171.  
  172.         The DAYSTAT.CFG file has instructions in it for modifications.
  173.  
  174.         Wait...  where are you going?  You know there's more to this
  175. thing, right??!  Come on...  it's only another page or so...
  176.  
  177. Frodo Section:
  178. -------------
  179.  
  180. Real quick...  The sections...
  181.  
  182. Inbound history...  It'll have the user's name, city, and time-online in
  183. the Cost column.  That way you can tell at a glance how long they were
  184. online.
  185.  
  186. As for the status screen....
  187.  
  188. Self-explanatory...  except the user has a node number?  11/45...
  189. they've called 11 times total, and spent 45 minutes online.  :^)
  190.  
  191. Watch it...  for some reason I can't get Frodo to release and share its
  192. files the way it should.  For this reason, I wouldn't run DayStat while
  193. Frodo is running.  Shouldn't be a real problem, since Frodo shouldn't be
  194. running anyway...  but just in case.  All it'll do is give you an error,
  195. but still...
  196.  
  197.  
  198. Registration:
  199. -------------
  200.  
  201. Sorry, but yep...  you have to register this FreeWare.  The way you do
  202. this, is call my system, fill out a six line questionnaire, and pick up
  203. your code.  Or else, if you don't have ANSI or just can't get through to
  204. the board, just send me NetMail with:
  205.         Your Name
  206.         Board's Name
  207.         Node Number
  208.         Phone Number
  209.         If you like the program/Whether I should take a flying leap/Etc.
  210.  
  211. Sorry about this, but after the apparent resounding lack of response to
  212. New2You...  By crackie, I wanted a way to see if people were using this
  213. thing.
  214.  
  215. Until you do, the today's callers screen will say " Today's Callers to:
  216. [Unregistered]", and the Frodo status will give [Unregistered] for the
  217. caller's city.
  218.  
  219. It should be easy as heck to crack this thing...  make you a key
  220. generator or whatever...  but my question is, why?  Generally to get to
  221. a really good board, you're gonna have to call L/D anyway...  why not
  222. call mine and get your key for free?  .sheesh.
  223.  
  224.  
  225.  
  226. The Miscellaneous Section That Everyone Dreads
  227. ----------------------------------------------
  228.  
  229. "Next Message Saved Saturday at 9:24pm...
  230. Sorry...  I'm just...  It started to hit me like a two-ton...  umm...
  231. heavy thing."  (Queensryche...  God luv 'em)  Whoops...  sorry bout
  232. that...
  233.  
  234. Anyway... .ahem. First off, the Today's callers list.  Sorry about the
  235. format, but if you call my board you'll see why it looks like that.  If
  236. you have a format you'd rather have in there, just send me an ANSI
  237. snippet of what you'd like it to be...  and IF it's not too much of a
  238. pain in the butt I'll stick it in for you.
  239.  
  240. Another thing...  when I was working on New2You, I averaged another 1.x
  241. version every couple of days.  You might want to check every now and
  242. again to see if there's a more recent version...  which I know there
  243. will be.  I've still got to add this stuff...
  244.  
  245.         * Uploads/Downloads Per day Graph
  246.         * Adding Up/Down Kb to Frodo inbound history
  247.         * .AVT Support (Maybe)
  248.         * Menued setup program
  249.         * Alternate .CFG files for multinode users
  250.         * Whatever else is suggested to me by youse guys.
  251.  
  252.  
  253.  
  254.  
  255. Sorry if I've come off a bit condescending but it's late, I'm tired, I
  256. want another cigarette, and I just love making up excuses.
  257.  
  258. .snicker.
  259.  
  260. -Jan
  261.  
  262. PS.       I'm at 1:362/970 if you need anything.
  263.  
  264. PS ][.    I'm including my .DAT file since (At this time) it only writes out
  265. for 35 days, and your graphs might look a bit empty for a while.  If you
  266. don't want to use it, just delete it.
  267.  
  268. PPS ]I[.  I'm also including some samples so you'll know what the various
  269.           outputs will look like before you bother messing with the config
  270.           file.  Sorry about the text-based setup, but it's easy to program
  271.           around.  :^)
  272.